home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / wmpack.z / wmpack
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. wwwwmmmmppppaaaacccckkkk((((3333GGGG))))                                                          wwwwmmmmppppaaaacccckkkk((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      wwwwmmmmppppaaaacccckkkk - specifies RGBA writemask with a single packed integer
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd wwwwmmmmppppaaaacccckkkk((((ppppaaaacccckkkk))))
  13.      uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg ppppaaaacccckkkk;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_a_c_k   expects a packed integer containing the RGBA (red, green, blue,
  17.             alpha) values you want to assign as the current write mask.
  18.             Expressed in hexadecimal, the format of the packed integer is
  19.             0x_a_a_b_b_g_g_r_r, where:
  20.  
  21.                _a_a   is the alpha value,
  22.                _b_b   is the blue value,
  23.                _g_g   is the green value, and
  24.                _r_r   is the red value.
  25.  
  26.             RGBA component values range from 0 to 0xFF (255).
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      wwwwmmmmppppaaaacccckkkk sets the red, green, blue, and alpha write mask components of the
  30.      currently active GL framebuffer, one of normal, popup, overlay, or
  31.      underlay as specified by ddddrrrraaaawwwwmmmmooooddddeeee.  The current framebuffer must be in
  32.      RGB mode for the wwwwmmmmppppaaaacccckkkk command to be applicable.  All drawing into the
  33.      color bitplanes of the current framebuffer is masked by the current write
  34.      mask.  Write mask components are retained in each draw mode, so when a
  35.      draw mode is re-entered, the red, green, blue, and alpha masks are reset
  36.      to the last values specified in that draw mode.
  37.  
  38.      Each write mask component is an 8-bit mask, which allows changes only to
  39.      bitplanes corresponding to ones in the mask.  For example,
  40.      wwwwmmmmppppaaaacccckkkk((((0000xxxxFFFFFFFF0000000000000000FFFF0000)))) allows changes only to the 4 most significant bits of
  41.      red, and to all the bits of alpha.
  42.  
  43.      It is an error to call wwwwmmmmppppaaaacccckkkk while the current framebuffer is in color
  44.      map mode.
  45.  
  46.      The write mask components of all framebuffers in RGB mode are set to 0xFF
  47.      when ggggccccoooonnnnffffiiiigggg is called.
  48.  
  49. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  50.      cpack, drawmode, gRGBmask, RGBmode
  51.  
  52. NNNNOOOOTTTTEEEE
  53.      Because only the normal framebuffer currently supports RGB mode, wwwwmmmmppppaaaacccckkkk
  54.      should be called only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.  Use ggggeeeettttggggddddeeeesssscccc to
  55.      determine whether RGB mode is available in draw mode NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  56.  
  57.      On Impact and Infinite Reality only whole components can be masked.  RGB
  58.      and A can be completely masked or not masked at all.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.